Overview

Adds code that can read the xml files generated by C# documentation comments and display those comments (currently the <summary> block) below types and variables in View Variables windows.

This PR doesn't (yet) actually toggle the xml doc file generation. You should add <GenerateDocumentationFile>True</GenerateDocumentationFile> to the csproj of the project you want to generate docs for then copy the resulting xml file into Resources/ViewVariables. You can use this to test this PR with the xml docs from content as well.

I will do a content PR when this gets merged but to test you need to add:

    <ViewVariables>true</ViewVariables>
    <VVRobustProjectDir>RobustToolbox</VVRobustProjectDir>

to the Content csproj files to get them generating the doc files correctly.

The xml docs are a little big, and they contain a bunch of info we're never going to use like function documentation. It wouldn't be to hard to have a script that discards unneeded entries to optimize the size of the resulting files.

All the individual doc strings are loaded from the client resources folder, we don't send the doc strings over the network.

Since this info comes from the code (just like the type and variable names) we can't really expect to localize this text. That may be a deal-breaker.

TODO

• fix xml tags inside the <summary> block breaking the doc string.
  • Most of the tags are now good enough, I would like to try implementing <inheritdoc/> but it might be in a follow-up PR.
• actually add <GenerateDocumentationFile> to the csproj files.
  • I spent some time in the MSBuild mines and I found a way to get the xml doc to write to the Resources folder cleanly. Right now it's only enabled for the Robust DLLS. If you want to test it locally you can add <ViewVariables>true</ViewVariables> to the Content DLLS. You may need to an an empty Resources\ViewVariables\ folder for the build to work properly.
• post-compile script to move the generated xml files into the Resources folder
  • See above.
• post-compile process to trim down the size of the xml files (discard all method definitions)
  • XmlDocTool implemented and working 👍
• Add support for <viewvariables> block inside the xml comments that can add docs tailor-made for vv

[ ] cleaner code
[ ] (?) CVar config?
[ ] (?) Improve the UI slightly to better accommodate the new doc strings